前言

在前幾天我們認識了 API 的角色、RESTful 設計原則，以及 HTTP 狀態碼。今天要更進一步，來看看 API 的基礎互動方式：請求（Request） 和 回應（Response）。

什麼是 Request（請求）？

當我們要跟 API 溝通時，首先要送出一個「請求」。這就像你去餐廳點餐，你要先告訴服務生你要什麼。

Request 的組成

一個 HTTP Request 主要包含：

1.方法（Method）
例如:

• GET:拿資料
• POST：新增資料
• PUT：更新資料
• DELETE：刪除資料

2.網址（URL / Endpoint）
例如：
https://api.example.com/todos

3.標頭（Headers）
裡面可能包含：

• 認證資訊（Authorization）
• 資料格式（Content-Type: application/json）

4.主體（Body）
當你要送資料給 API（例如新增一筆待辦事項），會放在 Body 裡。

什麼是 Response（回應）？

API 收到 Request 後，會回傳一個 Response，告訴你結果。這就像服務生把餐點送到你桌上。

Response 的組成

1.狀態碼（Status Code）
告訴你成功還是失敗，例如：

• 200 OK：成功
• 404 Not Found：找不到資源
• 500 Internal Server Error：伺服器錯誤

2.標頭（Headers）
例如回應格式： Content-Type: application/json

3.主體（Body）
真正的資料內容

小結

• Request 就像顧客點餐，要告訴 API 你需要什麼。
• Response 就像餐點送上桌，是 API 回覆給你的結果。
• 理解這一來一往的過程，是學習 API 的第一步。